home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 3: Developer Tools / Linux Cubed Series 3 - Developer Tools.iso / devel / lang / c / c-tools-.000 / c-tools- / c-tools-0.4 / README < prev    next >
Encoding:
Text File  |  1995-08-13  |  3.1 KB  |  110 lines
  1. -- c-tools 0.4 --
  2. $Id: README,v 1.28 1995/08/12 14:47:53 sandro Exp $
  3.  
  4. c-tools README
  5. Copyright (c) 1995 Sandro Sigala. <sansig@freenet.hut.fi>
  6.  
  7. This stuff is released under the GNU General Public License.
  8.  
  9. This release of c-tools consist of four simple programs that can
  10. be useful for programmers and others guys.
  11.  
  12. cinfo        a C libraries information tool
  13. highlight    highlight C source file with colors
  14. obscure        make a C source file unreadable but compilable
  15. hsort        sort #include directives in C source files
  16.  
  17. All the programs have an help (-h) option. For more help read the man pages.
  18.  
  19. ---
  20. cinfo usage:
  21. usage: cinfo [-hm] [-l libfile] [-o outfile] [symbol]
  22.        -h         display this help and exit
  23.        -m         make output more program-parseable
  24.        -l libfile specify the library to load instead the default
  25.        -o outfile specify the output file instead the standard output
  26.  
  27. highlight usage:
  28. usage: highlight [-hd] [input [output]]
  29.        -h        display this help and exit
  30.        -d        tread directives as single characters
  31.  
  32. obscure usage:
  33. usage: obscure [-huis] [-w width] [-a file] [-n file] [-p prefix]
  34.                [input [output]]
  35.        -h        display this help and exit
  36.        -u        make very unreadable output
  37.        -i        do not change identifiers
  38.        -s        use silly words instead of numbers for the identifiers
  39.        -w width  set the width of the output
  40.        -a file   add first the identifiers contained in this file
  41.        -n file   do not change the identifiers contained in this file
  42.        -p prefix use this prefix as the prefix of the identifiers
  43.  
  44. hsort usage:
  45. usage: hsort [-h] [input [output]]
  46.        -h        display this help and exit
  47.  
  48. ---
  49.  
  50. IMHO, the order of utility of the tools:
  51. HIGHEST
  52. ...
  53. cinfo (== a must have)
  54. ...
  55. obscure
  56. highlight
  57. hsort
  58. LOWEST
  59.  
  60. ---
  61.  
  62. HOW TO BUILD / TEST
  63.  
  64. to make the whole thing type:
  65. make
  66.  
  67. to install the binaries and cinfo files type:
  68. make install
  69.  
  70. to install the man pages type:
  71. make maninstall
  72.  
  73. to test the programs type: 
  74. cd examples
  75. make test
  76.  
  77. NOTICE
  78.  
  79. This program is free software; you can redistribute it and/or modify
  80. it under the terms of the GNU General Public License as published by
  81. the Free Software Foundation; either version 2 of the License, or
  82. (at your option) any later version.
  83.  
  84. This program is distributed in the hope that it will be useful,
  85. but WITHOUT ANY WARRANTY; without even the implied warranty of
  86. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  87. GNU General Public License for more details.
  88.  
  89. You should have received a copy of the GNU General Public License
  90. along with this program; if not, write to the Free Software
  91. Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  92.  
  93. ---
  94.  
  95. Post Scriptum
  96.  - All those programs were written in a half dozen of days,
  97.    then probably they contain many bugs. Please send me corrections.
  98.  - My english is bad, so send me corrections :).
  99.  - Those programs can be freely used and modified.
  100.  
  101. Copyright (c) 1995 Sandro Sigala.
  102. Send patches, suggestions, flames, etc. to <sansig@freenet.hut.fi>.
  103. At your option you may send they to /dev/null.
  104.  
  105. home address
  106. Sandro Sigala
  107. via Zendrini, 1
  108. 25047 Darfo Boario Terme
  109. Brescia - ITALY
  110.